home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_483 / pwkeys / pwkeys.doc < prev    next >
Text File  |  1992-05-06  |  7KB  |  211 lines
  1.  
  2.                              //
  3.                          \\ // PWKeys V1.0
  4.                           \//
  5.  
  6.                                1991
  7.                                 by
  8.                           Preben Nielsen
  9.  
  10.  
  11. WHAT IS PWKEYS ?
  12.  
  13.     PWKeys is an input-handler that allows you to move windows and
  14.   screens by pressing keys on the keyboard (a lot faster than using
  15.   the mouse).
  16.  
  17.  
  18. HOW TO START PWKEYS
  19.  
  20.     From CLI      : Type 'PWKeys' and press RETURN.
  21.                     There is NO need to use 'RUN', 'RUNBACK', 'ARUN' etc.
  22.                     PWKeys terminates immediately leaving only the handler
  23.                     in memory (only 1124 bytes).
  24.  
  25.                     To use other key-bindings than the default type:
  26.                     'PWKeys filename' where 'filename' is the name of
  27.                     a file created by the program SetPWKeys.
  28.  
  29.     From Workbench: Double-click on the PWKeys icon.
  30.  
  31.                     To use other key-bindings than the default you
  32.                     can do two thing:
  33.  
  34.                     1.
  35.                       a. Single-click on the PWKeys icon (its a Tool Icon)
  36.                       b. Select 'Info' from the 'Project' menu
  37.                       c. In the 'Tool Types' field write 'FILE=filename'
  38.                          where 'filename' is the name of a file created
  39.                          by the program SetPWKeys.
  40.  
  41.                     2.
  42.                       a. Create a Project icon
  43.                       b. Single-click on the the icon
  44.                       c. Select 'Info' from the 'Project' menu
  45.                       d. In the 'Tool Types' field write 'FILE=filename'
  46.                          where 'filename' is the name of a file created
  47.                          by the program SetPWKeys.
  48.                       e. In the 'Default Tool' field write the pathname
  49.                          of PWKeys program (e.g. 'SYS:utilties/PWKeys' if
  50.                          PWKeys is in the utilities drawer on SYS:
  51.  
  52.  
  53. HOW TO END PWKEYS
  54.  
  55.     To remove PWKeys simply
  56.     1. double-click its icon again
  57.      or
  58.     2. type 'PWKeys' RETURN in a CLI.
  59.  
  60.  
  61. WHAT CAN PWKEYS DO ??
  62.  
  63.     PWKeys lets you perform 17 functions on windows/screens.
  64.   These functions are:
  65.  
  66.   Window-to-top            : Moves the active window to the
  67.                   top of the screen
  68.  
  69.   Window-to-bottom        : Moves the active window to the
  70.                   bottom of the screen
  71.  
  72.   Window-to-left        : Moves the active window to the
  73.                   left of the screen
  74.  
  75.   Window-to-right        : Moves the active window to the
  76.                   right of the screen
  77.  
  78.   Window-to-left-top        : Moves the active window to the
  79.                   upper left corner of the screen
  80.  
  81.   Window-to-left-bottom        : Moves the active window to the
  82.                   lower left corner of the screen
  83.  
  84.   Window-to-right-top        : Moves the active window to the
  85.                   upper right corner of the screen
  86.  
  87.   Window-to-right-bottom    : Moves the active window to the
  88.                   lower left corner of the screen
  89.  
  90.   Window-to-center        : Centers the active window on the
  91.                   screen
  92.  
  93.   Window-to-front        : Moves the active window in front
  94.                   of all others on the screen
  95.  
  96.   Window-to-back        : Moves the active window behind all
  97.                   others on the screen
  98.  
  99.   Activate-previous-window  : Activates the window behind the
  100.                   currently-active one.
  101.  
  102.   Activate-next-window        : Activates the window above the
  103.                   currently-active one.
  104.  
  105.   Back-window-to-front        : Moves the back-most window to the
  106.                   front and activates it
  107.  
  108.   Front-window-to-back        : Moves the front-most window to the
  109.                   back and activates the new front-most
  110.                   window
  111.  
  112.   Back-screen-to-front        : Moves the back-most screen to the
  113.                   front and activates it's top-most window
  114.  
  115.   Front-screen-to-back        : Moves the front-most screen to the
  116.                   back and activates the top-most window on
  117.                   the new front-most screen
  118.  
  119.  
  120.   By default PWKeys binds the functions to following key-combinations:
  121.  
  122.  LAMIGA-KP1        : Window-to-left-bottom \
  123.  LAMIGA-KP2        : Window-to-bottom       \
  124.  LAMIGA-KP3        : Window-to-right-bottom  \
  125.  LAMIGA-KP4        : Window-to-left           \ Take a look at the
  126.  LAMIGA-KP5        : Window-to-center          >numeric keyboard to
  127.  LAMIGA-KP6        : Window-to-right          / why I chose these
  128.  LAMIGA-KP7        : Window-to-left-top      /
  129.  LAMIGA-KP8        : Window-to-top          /
  130.  LAMIGA-KP9        : Window-to-right       /
  131.  
  132.  LAMIGA-LEFTARROW    : Activate-previous-window
  133.  LAMIGE-RIGHTARROW    : Activate-next-window
  134.  
  135.  LAMIGA-UPARROW        : Window-to-back
  136.  LAMIGA-DOWNARROW    : Window-to-front
  137.  
  138.  LSHIFT-LAMIGA-UPARROW    : Front-window-to-back
  139.  LSHIFT-LAMIGA-DOWNARROW: Back-window-to-front
  140.  
  141.  RAMIGA-UPARROW        : Front-screen-to-back
  142.  RAMIGA-DOWNARROW    : Back-screen-to-front
  143.  
  144.  where
  145.  
  146.  LAMIGA     means the left Amiga key
  147.  RAMIGA     means the right Amiga key
  148.  LSHIFT     means the left shift key
  149.  KP1        means '1' on the numeric keyboard
  150.  KP2        means '2' on the numeric keyboard
  151.  KP3        means '3' on the numeric keyboard
  152.  KP4        means '4' on the numeric keyboard
  153.  KP5        means '5' on the numeric keyboard
  154.  KP6        means '6' on the numeric keyboard
  155.  KP7        means '7' on the numeric keyboard
  156.  KP8        means '8' on the numeric keyboard
  157.  KP9        means '9' on the numeric keyboard
  158.  UPARROW    means arrow-up key
  159.  DOWNARROW  means arrow-down key
  160.  RIGHTARROW means arrow-right key
  161.  LEFTARROW  means arrow-left key
  162.  
  163.  
  164.     To overwrite the default bindings above use the program SetPWKeys
  165.   which will let you bind each of the 17 function to any key-combination
  166.   you may prefer.
  167.  
  168.  
  169. WHY WON'T IT SOMETIMES WORK ??
  170.  
  171.   1.  Intuition will not let you manipulate screens and windows in
  172.       any way if the active window has an active gadget in it (especially
  173.       stringgadgets), so in these cases PWKeys won't try to do anything.
  174.  
  175.   2.  PWKeys won't try to MOVE backdrop-windows
  176.  
  177.  
  178. HOW DOES PWKEYS WORK ?
  179.  
  180.     PWKeys works by installing an input-handler at priority 51. This
  181.   handler recieves every input-event before Intuition does. It then
  182.   compares every raw-key event with the key-bindings you have made
  183.   (using binary search) and executes the associated function if it
  184.   finds a match.
  185.  
  186.  
  187. FUTURE FEATURES:
  188.  
  189.  » The ability to minimize/maximize windows
  190.  
  191.  » The ability to bind a function to more than one key-definition. This
  192.    would allow something like SHIFT-UPARROW (i.e. the ability to activate
  193.    a function by pressing either LSHIFT-UPARROW or RSHIFT-UPARROW). It is
  194.    actually not PWKeys fault that this is not currently possible. SetPWkeys
  195.    is to blame for this.
  196.  
  197.  
  198. CREDITS:
  199.  
  200.     Davide P. Cervone for his wKeys from Fisk-disk 128.
  201.  
  202. =====================================================================
  203.    Send bug-reports, suggestions, comments etc. to:
  204.  
  205.         ///
  206.        ///  Preben Nielsen
  207.  \\\  ///  Oehlenschlægersgade 72 st. T.V.
  208.   \\\///  1663 Copenhagen V.
  209.    \///  Denmark
  210.  
  211.